home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / programming / ixemul-complete / man / cat2 / mkdir.0 < prev    next >
Text File  |  1996-09-01  |  3KB  |  77 lines
  1.  
  2. MKDIR(2)                   UNIX Programmer's Manual                   MKDIR(2)
  3.  
  4. NNAAMMEE
  5.      mmkkddiirr - make a directory file
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ttyyppeess..hh>>
  9.      ##iinncclluuddee <<ssyyss//ssttaatt..hh>>
  10.  
  11.      _i_n_t
  12.      mmkkddiirr(_c_o_n_s_t _c_h_a_r _*_p_a_t_h, _m_o_d_e___t _m_o_d_e)
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      The directory _p_a_t_h is created with the access permissions specified by
  16.      _m_o_d_e and restricted by the the umask(2) of the calling process.
  17.  
  18.      The directory's owner ID is set to the process's effective user ID.  The
  19.      directory's group ID is set to that of the parent directory in which it
  20.      is created.
  21.  
  22. RREETTUURRNN VVAALLUUEESS
  23.      A 0 return value indicates success.  A -1 return value indicates an er-
  24.      ror, and an error code is stored in _e_r_r_n_o.
  25.  
  26. EERRRROORRSS
  27.      MMkkddiirr() will fail and no directory will be created if:
  28.  
  29.      [ENOTDIR]     A component of the path prefix is not a directory.
  30.  
  31.      [ENAMETOOLONG]
  32.                    A component of a pathname exceeded {NAME_MAX} characters,
  33.                    or an entire path name exceeded {PATH_MAX} characters.
  34.  
  35.      [ENOENT]      A component of the path prefix does not exist.
  36.  
  37.      [EACCES]      Search permission is denied for a component of the path
  38.                    prefix.
  39.  
  40.      [ELOOP]       Too many symbolic links were encountered in translating the
  41.                    pathname.
  42.  
  43.      [EROFS]       The named file resides on a read-only file system.
  44.  
  45.      [EEXIST]      The named file exists.
  46.  
  47.      [ENOSPC]      The new directory cannot be created because there is no
  48.                    space left on the file system that will contain the direc-
  49.                    tory.
  50.  
  51.      [ENOSPC]      There are no free inodes on the file system on which the
  52.                    directory is being created.
  53.  
  54.      [EDQUOT]      The new directory cannot be created because the user's quo-
  55.                    ta of disk blocks on the file system that will contain the
  56.                    directory has been exhausted.
  57.  
  58.      [EDQUOT]      The user's quota of inodes on the file system on which the
  59.                    directory is being created has been exhausted.
  60.  
  61.      [EIO]         An I/O error occurred while making the directory entry or
  62.                    allocating the inode.
  63.  
  64.      [EIO]         An I/O error occurred while reading from or writing to the
  65.  
  66.                    file system.
  67.  
  68.      [EFAULT]      _P_a_t_h points outside the process's allocated address space.
  69.  
  70. SSEEEE AALLSSOO
  71.      chmod(2),  stat(2),  umask(2)
  72.  
  73. SSTTAANNDDAARRDDSS
  74.      The mmkkddiirr() function conforms to IEEE Std1003.1-1988 (``POSIX'').
  75.  
  76. 4.2 Berkeley Distribution      December 11, 1993                             2
  77.